home *** CD-ROM | disk | FTP | other *** search
/ Dictionaries & Language / Dictionaries and Language (Chestnut CD-ROM) (1993).iso / misc / ilt101 / ilt.doc next >
Encoding:
Text File  |  1991-08-06  |  18.3 KB  |  353 lines

  1.  
  2.  
  3.  
  4.  
  5.         I n t e r m e d i a t e - l e v e l   L a n g u a g e   T u t o r
  6.  
  7.         -----------------------------------------------------------------
  8.  
  9.         User's Guide To Operation
  10.  
  11.  
  12.  
  13.               Intermediate-level Language Tutor -- Version 1.01
  14.           Copyright (c) 1991 by Brian Francis Redman, all rights reserved.
  15.  
  16.  
  17.              The following files should be included with your copy of the 
  18.         distribution disk:                      
  19.              
  20.              ILT.DOC ........... Program documentation
  21.              ILT.EXE.............Front menu for all programs
  22.              ILTRD.EXE.......... Quiz program           
  23.              ILTBLD.EXE......... Build quizzes program             
  24.              ILTEDT.EXE......... Edit quizzes program
  25.              ILTSRCH.EXE.........Check for duplicate entries
  26.              INTERA.DAT......... Quiz file A     
  27.              INTERB.DAT......... Quiz file B            
  28.              INTERC.DAT......... Quiz file C           
  29.              INTERD.DAT......... Quiz file D
  30.              INTERE.DAT..........Quiz file E
  31.              INTERF.DAT..........Quiz file F
  32.              INTERG.DAT..........Quiz file G
  33.              
  34.  
  35.  
  36.        Anyone not charging an unreasonably high "duplication" fee (beyond 
  37.        whatever is the current norm for such fees), may freely copy and share 
  38.        exact duplicates  of The Intermediate-level Language Tutor.  All 
  39.        program and  documentation files must be distributed together and 
  40.        unmodified.
  41.  
  42.                    Intermediate-level Language Tutor Warranty
  43.  
  44.              There is no warranty of any kind associated with ILT.   You, 
  45.         the user, are advised to experiment and become familiar with  all 
  46.         of the programs before relying on them.  The correct meanings of  
  47.         the words in the quiz files is not guaranteed, however I have     
  48.         striven for accuracy as I too use this program. The meanings of
  49.         the words in the quizzes were obtained from various Spanish-English
  50.         dictionaries. Be aware that many of the words have other meanings
  51.         beyond what is indicated in the quiz files.
  52.  
  53.  
  54.                                 Table Of Contents
  55.  
  56.                                                                     Line
  57.  
  58.              Quick Start..............................................77
  59.  
  60.              Introduction ........................................... 90
  61.                   System Requirements ...............................110
  62.  
  63.              ILT -- front menu program...............................123
  64.  
  65.              ILTRD -- the quiz program...............................133
  66.  
  67.              ILTBLD -- build quizzes program.........................182
  68.  
  69.              ILTEDT -- edit quizzes program..........................253
  70.  
  71.              ILTSRCH -- search for duplicates........................281
  72.  
  73.              For Further Help........................................310
  74.  
  75.              History.................................................323
  76.  
  77.              A Final Note............................................335
  78.  
  79.  
  80.                           Quick Start
  81.  
  82.            If you don't enjoy reading documentation and just want to get 
  83.        started, my guess is that you will be able to run the ILTRD program 
  84.        quite easily. In fact I recommend that you go ahead and run the ILTRD 
  85.        program and come back and read the documentation later. Remember two
  86.        things:
  87.            1) enter ILTRD to begin
  88.            2) when asked for a letter A through Z, enter "A", "B", "C", "D", 
  89.        "E", "F", OR "G".
  90.                  ^^
  91.  
  92.  
  93.                           Introduction to the Programs 
  94.  
  95.  
  96.              The  present  version of these programs (except ILTSRCH.EXE),  
  97.         version  1.01,  was written  in  the BASIC programming language, 
  98.         using the SPECTRA  Power BASIC compiler. ILTSRCH was written in the 
  99.         BASIC programming language but using the Microsoft Quick Basic 
  100.         compiler (v 4.5). SPECTRA is a registered trademark of SPECTRA 
  101.         Publishing. Microsoft is a registered trademark of Microsoft 
  102.         Corporation.
  103.  
  104.              There  are four programs. ILTRD is the quiz program. It will
  105.         give you a 100 question, multiple choice quiz on the meanings of  
  106.         the words. ILTBLD allows you to create your own quiz files in     
  107.         Spanish, French, Italian, German, or English. ILTEDT allows you to
  108.         modify individual entries in the quiz files. ILTSRCH lets you
  109.         determine beforehand if a candidate word already exists in the
  110.         quiz files. This lets you avoid duplication of entries.
  111.  
  112.  
  113.                                System Requirements
  114.  
  115.              To  run,  The Intermediate-level Language Tutor requires the 
  116.         following "standard" equipment:
  117.  
  118.              a computer ............. IBM PC/XT/AT or somewhat compatible
  119.              an operating system .... MS-DOS or PC-DOS 2.0 or later
  120.              a monitor .............. Monochrome, Color, Enhanced 
  121.              memory ................. ???k free (unsure)                
  122.              disk drives ............ virtually anything
  123.  
  124.  
  125.                            =======
  126.                              ILT
  127.                            =======
  128.  
  129.            Enter ILT to start the program.
  130.            ILT serves as a front menu for the other programs. It is self- 
  131.        explanatory and thus I do not feel I need to explain it here. In the 
  132.        ILT program, you can press the F1 function key if you need help.              
  133.  
  134.  
  135.                            =========  
  136.                              ILTRD  
  137.                            =========
  138.  
  139.            Enter ILTRD to start the program.
  140.            You will be greeted with a title page. Press any key to move on 
  141.         to the main program.
  142.            You will be requested to enter a letter A-Z. These letters are 
  143.         linked to the quiz files INTERA.DAT, INTERB.DAT, INTERC.DAT ..... 
  144.         INTERY.DAT, INTERZ.DAT. Not all of these "DAT" files are initially 
  145.         present. For example, if you were to enter "S" and there were no 
  146.         corresponding INTERS.DAT file then you would get an error message 
  147.         saying that that file is not available. File selections A, B, C, D, 
  148.         E should be available. Beyond that (as of this writing) I do not 
  149.         know what else will be available.
  150.            You will also see in the top left of the screen (after you have 
  151.         passed the title page) the following line: F1 = Functions.  
  152.         Pressing the F1 key will toggle a list of available functions.
  153.            Now suppose you have entered the letter "A". The program will 
  154.         then read in the data from INTERA.DAT and randomly "shuffle" the 
  155.         order of the quiz questions. Thus, each time you take quiz "A" the 
  156.         order of the questions will be random. Besides this, ILTRD 
  157.         additionally "shuffles" the order of the responses for each quiz 
  158.         question. Thus you could not have the situation where you "knew" 
  159.         that the correct answer for "la mesa" was always "c".
  160.            The program is set up to give you a 100 question quiz and then 
  161.         end. I set it up this way because I thought it would thereby be 
  162.         less time consuming for the user. I thought the program would be
  163.         better as a sort of 10-minutes-a-day tool for learning. I did not 
  164.         want the program to be overused for a week and then collect dust. 
  165.         My hope is that you will use this program to slowly and steadily 
  166.         improve your understanding of whatever language you are studying. 
  167.         You can of course rerun the program if you decide you want to 
  168.         "cram."
  169.            Pressing either the F5 key or the ESC key will let you exit the 
  170.         program at any time.
  171.            Pressing F2 will give you online help with the program.
  172.            Pressing F3 will print a list of the words in the current quiz 
  173.         set along with their correct meanings. You can use this list as a 
  174.         study guide to the words for either yourself or your students.
  175.            Pressing F4 will print a quiz based on the current quiz set. 
  176.         When you press F4 you will have the option of changing (a) how many 
  177.         quizzes are printed and (b) the number of questions per quiz. Quiz 
  178.         questions are generated randomly, yet each individual quiz is the 
  179.         same as the others. In other words, for a 10-question quiz the 10 
  180.         quiz words will be selected at random from the current set and 
  181.         printed repeatedly for all quizzes.
  182.  
  183.  
  184.                            ==========
  185.                              ILTBLD
  186.                            ==========
  187.  
  188.            Enter ILTBLD to start the program.
  189.            You will be greeted with a title page. Press any key to 
  190.         continue.
  191.            Select the first letter of whatever language you will be using. 
  192.         For example, "S" for Spanish, "F" for French, etcetera.
  193.            Files A through G are filled (100 records) and cannot be added to. 
  194.         I recommend that you leave them as they are. If you find you need to 
  195.         modify files A - G, you will need to run the ILTEDT program (see     
  196.         below) to alter the contents. File letters H - Z are available for 
  197.         building extra files.
  198.            Select whichever quiz set you will be building. ILTBLD will keep 
  199.         track of how many records are in the selected quiz set and will 
  200.         automatically terminate execution when there are 100 records in the 
  201.         current quiz set. Thus, given that there are 26 letters in the 
  202.         alphabet, the maximum number of records you can have would *APPEAR* 
  203.         to be 2600 -- however you can get around this by storing different 
  204.         quiz sets on different files. For example, you could have a disk 
  205.         containing files which you had renamed using the DOS rename command 
  206.         as follows:  RENAME INTERA.DAT FRENCHA.DAT
  207.         Then, when you wanted to use these files, you could copy them to 
  208.         a separate directory using the DOS copy command as follows:
  209.                      COPY FRENCHA.DAT C:\WORKAREA
  210.         Next, you would have to rename the file to its original name. For 
  211.         example:     RENAME FRENCHA.DAT INTERA.DAT
  212.         Finally, after storing any ".DAT" files that are in whatever 
  213.         directory you are using to run the ILT programs, you would transfer 
  214.         the renamed FRENCHA.DAT file to the ILT directory as follows:
  215.                      COPY C:\WORKAREA\INTERA.DAT C:\ILT\INTERA.DAT
  216.            If the preceding has confused you i'm sorry. Depending on how 
  217.         many people use this program I may release future versions that are 
  218.         easier to work with. You can of course contact me via electronic 
  219.         mail at either Compuserve or Genie if you get stuck or have 
  220.         questions. Later on in this documentation i'll leave my E-mail 
  221.         addresses for those who wish to contact me.
  222.            At any rate, you will be prompted for a word, then for the 
  223.         meaning of that word. Then you will be asked to supply four false 
  224.         meanings to the word. To me, this was the hardest part of this 
  225.         program. You will need to come up with four words that 1)do not 
  226.         match *any* of the meanings of the foreign language word 2)are of 
  227.         the same type as the foreign language word (e.g. noun, verb, etc.) 
  228.         3)are somewhat tricky -- in other words not obviously a false 
  229.         answer. There is a F3 option which will give you a randomly 
  230.         generated bunching of letters that to me served as sort of an 
  231.         inkblot to suggest possible false answers; still, it is going to 
  232.         take effort on your part to arrive at four good false answers. I 
  233.         found that paging through a good-sized dictionary was also a help 
  234.         to finding some good false answers. If you add just 5 or so words a 
  235.         day to the quiz files, you will gradually build a powerful 
  236.         vocabulary.
  237.            If you make a mistake while entering a word, you can delete a part 
  238.         of or all of the entry by pressing the left arrow key (not the cursor 
  239.         left key) which is probably located to the right of the "90-=\" keys 
  240.         on your keyboard. If you have already entered the word and wish to 
  241.         change it, you will need to use the ILTEDT program (see below).
  242.            F4 will toggle a list of keys which are associated with the 
  243.         special alphabet characters of the particular language you are 
  244.         working with. For example, in Spanish you will see
  245.         1 - á  2 - é  3 - í  4 - ó  5 - ú  6 - ñ
  246.         These keys refer to the number keys 1, 2, 3, 4, ..., etc. (Don't 
  247.         confuse them with the function keys F1, F2, ..., etc.) So, if you 
  248.         wanted to enter the word "señor" you would press these keys: S E 6 
  249.         O R and "señor" would be echoed to the screen.
  250.            As always, pressing the F5 or "ESC" keys will let you quit the 
  251.         program. The F1 key will toggle a brief help line while F2 will 
  252.         give you more detailed help.
  253.  
  254.  
  255.                            ==========
  256.                              ILTEDT
  257.                            ==========
  258.  
  259.            Enter ILTEDT to begin.
  260.            You will be greeted with a title screen. Press any key to 
  261.         continue.
  262.            ILTEDT allows you to change anything you have entered in a 
  263.         record. This is useful if you find you have made an error in any of 
  264.         the record entries. Select the language (French, German, Spanish, or 
  265.         Italian) then the letter of the quiz set. Use the "Page Up" and "Page 
  266.         Down" keys to page through the records in increments of ten. Use the 
  267.         up and down cursor keys to page through the records in increments of 
  268.         1. Pressing the "Enter" or "Carriage Return" selects the current 
  269.         record for editing. You will be prompted for the number of the field 
  270.         to edit. Press the number key 1 through 6 and begin editing.
  271.            F1 will toggle a line showing a hint for what the function keys F1 
  272.         through F5 do.
  273.            F2 will toggle a list of language keys for the current set. The 
  274.         numbers listed correspond to the numeric keys at the top of the 
  275.         keyboard and not to the function keys.
  276.            F3 will list what keys control the program. For example, as 
  277.         already mentioned the up and down cursor keys are used to control 
  278.         paging through the records in increments of 1.
  279.            F4 will open an online help window.
  280.            F5 or the "ESC" key let you quit the program.
  281.  
  282.  
  283.                            ===========
  284.                              ILTSRCH
  285.                            ===========
  286.  
  287.            Enter ILTSRCH to begin.
  288.            The program will display that it is working. After about a minute 
  289.         it will ask you to select a language. Then you will be prompted for a 
  290.         search item.
  291.            ILTSRCH was written by me at the last moment when I saw that after 
  292.         awhile it wasn't easy to remember if I had already entered a word 
  293.         into the record sets or not. For example, I had entered "el regazo" 
  294.         but could not remember having done so. Rather than re-enter the word 
  295.         I ran ILTSRCH and when prompted for a search item I entered "el 
  296.         regazo"  The program found a match and so I knew not to enter "el 
  297.         regazo" into the record sets twice.
  298.            If you enter a word such as a noun, be sure to include the 
  299.         definite article if that is how you are storing the words. For 
  300.         example, if I had entered just "regazo" when prompted for a search 
  301.         string no match would have been found. On the other hand, if I had 
  302.         entered "el r" a match would have been found.
  303.            To quit the program you can press just the enter key alone when 
  304.         prompted for a search item or alternately, F1 will allow you to quit 
  305.         at any time.
  306.            As stated, ILTSRCH was thrown together at the last minute, while I 
  307.         was in the process of moving. Thus I know that improvements could be 
  308.         made. However I ran out of time and I wanted to get a version of the 
  309.         ILT programs out before I got bogged down in other things.
  310.  
  311.  
  312.                            ====================
  313.                              For Further Help
  314.                            ====================
  315.  
  316.            Let me hear from you! I can be reached by electronic mail at 
  317.         either Compuserve (72567,3145) or Genie (B.REDMAN). I know that 
  318.         improvements can be made to this program, however I have held off 
  319.         because I thought "Suppose I am the only one who winds up using 
  320.         this?" Let me know if you are using ILT, what you do or don't like 
  321.         about it, any problems you have with it, and any ideas you have about 
  322.         what could be added to the program to improve it.
  323.  
  324.  
  325.                            ===========
  326.                              History
  327.                            ===========
  328.  
  329.            Version 1.0       Released July 1991
  330.  
  331.            Version 1.01      August 1991
  332.                              Fixed a bug in the ILTBLD program which was
  333.                              allowing more than 100 elements into data files
  334.                              (i.e. files with ".DAT" extension).
  335.  
  336.  
  337.                            ================
  338.                              A Final Note
  339.                            ================
  340.  
  341.            I began to write this program because I wanted to be able to read 
  342.         and enjoy Spanish literature. As of this writing I have recently 
  343.         graduated from Northern Illinois University with a B.A. in Spanish. 
  344.         And the sad thing is that I do not feel that I can read Spanish. I'm 
  345.         not saying that I don't know Spanish, its just that whenever I try to 
  346.         read Spanish literature I am constantly having to stop and look up 
  347.         the meanings of words. And when I say constantly, I mean at least 
  348.         five words every page. This constant stopping to look up the 
  349.         meanings of words is aggravating. Thus, I am still unable to *enjoy* 
  350.         Spanish literature. My hope is that this program will gradually 
  351.         remedy that situation for me and perhaps for you.                  
  352.  
  353.